<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
</head>

<body>
<header>
</header>

<pre><hr><b>RELEASE </b>
    Release 2.1

<b>NAME</b>
    stopCmd - stop or terminate a command that is submitted to the grid.

<b>SYNOPSIS</b>
    stopCmd [command id]<br>    stopCmd -c [command id]<br>    stopCmd -s [state]<br>    stopCmd -g [grid id]<br><b><br>DESCRIPTION</b>
    stopCmd sends a stop signal to the commands running on the grid only if owned<br>    by the invoking user. The username is always defaults to the invoking user.<br>    A user can only send stop requests to his own jobs.<br><br>    stopCmd doesn't wait for the command to stop and makes no guarantee that the<br>    command will stop.

<b>EXAMPLES</b>
    
    1. Stopping a command passing the id<br>      &gt; stopCmd 16045<br><br>    2. Stopping a command by the id saved in a file<br>      &gt; stopCmd `cat .cid.4056`<br><br>    3. Stopping all RUNNING commands own by the user<br>      &gt; stopCmd -s RUNNING<br><br>    4. Stopping all commands own by the user<br>      &gt; stopCmd -s ALL<br><br>    5. Stopping a command by it's grid id. the grid id is usually obtained from either<br>       from htc status page or 'qstat' command.<br>      &gt; stopCmd -g 1536754<br><b><br>OPTIONS</b>
   -h, --help<br>    Print out this help text and exit.<br><br>    -c [HTC ID]<br>    HTC ID is the id of this Command. Usually found<br>    on the HTC status page.<br><br>    -s [STATE]<br>    STATE of the Commands that need to be stopped.<br>    Valid values are 'INIT', 'WAITING', 'RUNNING'<br>    or 'ALL'. Usually a command state can be found<br>    on HTC status page.<br><br>    -g [GRID ID]<br>    GRID ID is the corresponding grid id of the<br>    Command submitted to the grid through runCmd<br>    or HTCService. Usually found on the HTC status<br>    page or from the 'qstat' command.<br>
    
<b>EXIT CODES</b>
    Returns 0 on success and -1 on an error

<b>Dependencies</b>
    TIGR::HTCRequest 

<b>Location of Manual<br>
   http://intranet/~sgeworker/stopCmd.html

<b>Author</b>
    Antware Team, antware@tigr.org The Institute for Genomic Research


Copyright (c) 2003, The Institute for Genomic Research. All rights reserved.

</b><hr>


<b>Copyright (c) 2003, The Institute for Genomic Research. All rights reserved.<br><br></b></pre>

</body>
</html>
